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+ + + 

I i i 

I INTRODUCTION | CHAPTER 1 | 

i I i 



The HP-DIO Four Channel Multiplexer is a microprocessor based 
(Z-80), four channel, asynchronous interface for the HP-DIO backplanes. 
Three of the channels are direct connect ports. The fourth is a modem 
port which may be used as a direct connect port. This product will be 
referred to as FORDYCE throughout this document. 

Although the card has a processor on board, the card is basically 
dumb from an external viewpoint. The caxd does very little on-board 
character processing. The main function of the firmware is to raauiage the 
FIFO buffers in which the data will be passed between the card and the 
host. 

The purpose of this document is to outline the preliminary design of 
the firmware for the FORDYCE card. The following areas will be covered: 

1. Overview 

2. Hardware Considerations & Default Settings 

3. Interface Registers 

k. Shared Memory Access and Data Formats 

5. Interrupts 

6. Self Test 

7. Pseudocode Outlines of Buffer Access Routines 



!niis document is for HP internal use only. 



1.1 FEATURES 

*EIA RS-232-C and CCITT V.28 compatibility 

*Special character recognition 

*Break detection 

*Break generation via host command 

*The card will generate an interrupt to the host every l6 millsecs. 
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*128 character receive buffers and l6 character trauismit buffers 
for each of the four ports 

♦Supported baud rates: 110, 13^.5, 150, 300, 600, 1200, 2U00, 

1*800, 9600, or 19.2k 

*Baud rate defaults to 96OO and is software prograjnmable to. any of 
16 rates 

*Parity checking: odd, even, or none 

•Number of Stop bits: 1 or 2 

♦Number of Data bits per character: 7 or 8 

♦Transmission mode: Full-duplex 



1.2 OTHER FEATURES (NOT OFFICIALLY SUPPORTED) 

The following features exist onthe card but axe deemed to to be 
important enough to be given official HP support and all that entails. 

If invoked, the card will attempt to enable the desired feature, but 
no waxranty is expressed or implied. 

♦Additional BAUD rates: 50, 75, 900, I8OO, 36OO, 7200, and 38UOO 

♦Additional chaxacter lengths of 5 and 6 bits 

♦1.5 stop bits 
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MEMORY ADDRESS SPACE 



I CHAPTER 2 



The card contains a total of 2K of shared RAM and 8K of ROM. 
However, the Z-80 has am address space of 6kK bytes. The following 
diagram illustrates the practical division of this address space on 
the FORDYCE card. 
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2.1 RAM MAP 



The following map displays the organization of the 2K of shared 
RAM on the caxd. 
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OVERVIEW OF SHARED MEMORY SCHEME 



i CHAPTER 3 



Data will be passed between the card and the host in circular 
FIFO data buffers. There are a total of eight of these buffers; four 
Receive buffers (one for each poirt) and four Transmit buffers (one for 
each port). These buffers will be accessed by both the card and the 
host. The shaxed memory scheme gives rise to four basic types of 
memory accesses (illustrated below). The handshaking between the driver 
and the firmwaxe on the card must be coordinated to allow all foxir to 
function in an acceptable manner for the speed and priority constraints. 



HOST BUFFER ACCESS 



CARD BUFFER ACCESS 



Receive data 
from channel < 



Transmit data 
to chaumel 



I RECEIVE I 
I BUFFERS i 



I TRANSMIT I 
I BUFFERS I 



Receive data 
from channel 



Transmit data 
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Shared RAM 



3.1 PASSING DATA BETWEEN THE CARD & HOST 



The following is a general overview of how transmit and receive data 
is passed between the card and the host. 
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3.1.1 RECEIVE DATA FROM CHANNEL 



Receive data processing is divided into two basic parts: Putting 
data into the buffers (card processing) and removing data from the 
buffers (host processing). 

When a chaxacter arrives, the card will retrieve it from the UART, 
and check the Bit Map to see if it is to be processed as a special 
chairacter. If so, the caxd will send a Special Character interrupt to 
the host. The card will then write the character to the appropriate 
Receive buffer. 

Each character written to the Receive buffers will have an 
accompanying status byte. The status bsrte will indicate whether a 
framing error, parity error, overrun error, FIFO overflow error or break 
occurred for the chaxacter. If no error or brealc occurred, the status 
byte will contain a zero. 

The host will check the Receive buffers for data each time it 
receives a Timer interrupt. The card will send the host a Timer 
interrupt every l6 milliseconds regardless of the state of the receive 
buffers. The host will check each buffer and empty all data it finds. 



3.1.2 TRANSMIT DATA TO THE CHANNEL 



When the host has treuismit data to send it first checks the Transmit 
buffer. If full, the host must back off and wait for a TX Buffer Empty 
interrupt from the caxd. If the buffer is not full, the host will place 
chaxacters in the buffer until either the buffer is full or the host is 
done. If the host put characters into a buffer that was empty, the host 
sends a TX Buffer Not Empty interrupt to the card indicating that there 
is now data in the buffer. 

When the caxd receives the TX Buffer Not Empty interrupt from the 
host, it will begin to empty the Transmit buffer. When the caxd has 
finished, it will send a TX Buffer Empty to the host. If the host does 
not have data to send, it will simply ignore the intei*rupt. 
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I II 

I HARDWARE CONSIDERATIONS and DEFAULT SETTINGS | CHAPTER k \ 



The FORDYCE card consists of a Z-80A microprocessor, 2K of RAM 
(shared), 8K of ROM, two Z-80 CTC's (Counter Timer Clocks), and two Z-80 
SIO/2 chips (UARTs). There are 8 DIP switches on the card. 



DIP SWITCH 
0-k) 
5,6 
7 



USED FOR 

SELECT CODE 

CARD INTERRUPT PRIORITY 

CONSOLE CONNECTION - YES OR NO 



DEFAULT SETTING 

13 (IffiCIMAL) 
3 (HIGHEST) 
1 (YES) 



k,l 



CTC TIMERS 



As mentioned previously, there are two CTC chips on the FORDYCE 
card. Each chip has four counter/timer chainnels for a total of 8 
available on the card. Four of these are used as baud rate generators 
and one is used as a receive buffer time-out timer. The remaining three 
channels are unused. 



CTC CHANNEL 



CTC 



CTC 



CHANNEL 
CHANNEL 1 
CHANNEL 2 
CHANNEL 3 



1 CHANNEL 
CHANNEL 1 
CHANNEL 2 
CHANNEL 3 



USED FOR 

BAUD RATE GENERATOR FOR PORT 
BAUD RATE GENERATOR FOR PORT 1 
HOST INTERRUPT LINE 
UNUSED 

BAUD RATE GENERATOR FOR PORT 2 
BAUD RATE GENERATOR FOR PORT 3 
TIME-OUT TIMER FOR RX BUFFERS 
UNUSED 
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k.2 



SIO OUTPUT LINES 



There axe two SIO chips, each of which has two chauinels and two sets 
of modem lines. The following is a sumraaJT^ of the uses of the modem 
lines. The SYNC lines are included because one will be used as a modem 
line. 







SIO 


MODEM 








LINE 


SYMBOL 


USED AS 


SIO CHANNEL 


A 


RTS 


RS 


REQUEST TO SEND - OUTPUT 


(PORT 0) 




DTR 


TR 


TERMINAL READY - OUTPUT 






CTS 


CS 


CLEAR TO SEND - INPUT 






DCD 


RR 


RECEIVER READY - INPUT 






SXNC 


DM 


DATA MODE - INPUT 


SIO CHANNEL 


B 


RTS 


SR 


SIGNAL RATE SELECTOR - OUTPUT 


(PORT 1) 




DTR 
CTS 




UNUSED 

HOOD DETECT - PORT 1 






DCD 


IC 


INCC»1ING CALL - INPUT 


SIO 1 CHANNEL 


A 


RTS 




UNUSED 


(PORT 2) 




DTR 
CTS 
DCD 
SYNC 




UNUSED 

HOOD DETECT - PORT 2 

UNUSED 

UNUSED 


SIO 1 CHANNEL 


B 


RTS 




ENABLE FRONTPLANE DRIVERS 


(PORT 3) 




DTR 
CTS 
DCD 




UNUSED 

HOOD DETECi' - PORT 3 

UNUSED 



NOTE: To detect a hood for Port 0, the firmware will first clear 
the TR line , then perform a loopback check on the IC and 
SR lines (These two are looped together in the modem port 
test hood) . 



U.3 



FIRMWARE PRIORITY SCHEME 



All firmware events will be interrupt driven. When the Z-80 is 
executing an Interrupt Service Routine, interrupts will be disabled to 
prevent another interrupt from preempting the current routine. 
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Therefore, the priority of the interrupts is dependent upon the priority 
of the SIO and CTC channels and their placement on the interrupt daisy 
chain. The following is a list of the major firmware events in order of 
their priority. (high to low) 

1. RECEIVE DATA - PORT 

2. TRANSMIT DATA - PORT 

3. MODEM LINE CHANGES - CS, DM, and RR 
k. RECEIVE DATA - PORT 1 

5. TRANSMIT DATA - PORT 1 

6. MODEM LINE CHANGES - IC 

7. RECEIVE DATA - PORT 2 

8. TRANSMIT DATA - PORT 2 

9. RECEIVE DATA - PORT 3 

10. TRANSMIT DATA - PORT 3 

11. TIMER INTERRUPTS 

12. HOST INTERRUPTS 



k.k TEST HOODS 



The FORDYCE card physically has three direct connect RJ-11 
ports aaid one 25 pin standard modem port. As mentioned previously, 
the modem port may also be used as a direct connect port. 

There will be two types of test hoods for the FORDYCE card, one 
for the direct connect port and one for the modem port. The test 
hoods for the direct connect ports consist of an RJ-11 plug with the 
wires looped back. The test hood for the modem port will be a staaidaxd 
25 pin modem connector with the ouput modem lines connected to the 
input modem lines. 

Any number of test hoods may be connected to the board for Self 
Test. In other words, during Self Test, the firmware will check each 
port for a test hood. If no test hood is present on a particular port, 
the Self Test will simply skip the external loopback test for that 
port . 



k,3 DEFAULT LINE CHARACTERISTICS AND FORMAT 



When the caprd powers up, it will set up the UARTs with the 
default line chaxacteristics. The host will be able to change these 
after Self Test and Initialization. The following is a list of 
each line characteristic and its default value. The default line 
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chaxacteristics will be the same for each port, 

1. SPEED - 9600 BAUD 

2. NUMBER OF STOP BITS - 1 

3. PARITY - NONE 

k, NUMBER OF BITS PER CHARACTER - 8 



k,6 DEFAULT BIT MAP 



After caxd initialization, the Bit Map will be cleared (i.e. all 
locations =0). In other words, the caxd will not be set to recognize 
amy character. 



k,J DEFAULT TIMER SETTING 



The 16 millisecond timer will be off after power up and card 
initialization. The host is responsible for enabling the timer. 
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INTERFACE REGISTERS | CHAPTER 5 



Interface Registers are the Hardware Registers and RAM locations 
(also called registers) that are accessed by both the card and the host. 
All of the communication between the card aind the host will be performed 
by passing information between these registers. Although the FIFO 
buffers could also be included in this category, they will be discussed 
in another chapter since they involve special handshaking. 

It should be noted that although technically speaking, all of the 
RAM on the caird can be accessed by both the card and the host, there is a 
portion that is reserved for the card use only. Since there is no 
haxdwaxe protection mechanism for this portion of RAM, the host will have 
to be caxeful not to access those locations . 



5.1 HARDWARE REGISTERS 



The following is a brief description of the haxdware registers on 
the FORDYCE card. These registers are; 



1. Reset I.D. register 

2. Interrupt register 

3. Semaphore register 



5.1.1 RESET/I. D. REGISTER 



Z-80 ADDRESS: 8OOOH 
MAINFRAME ADDRESS: OOOIH 

This register is used to reset the card and to contain the caxd 
identification information. On the FORDYCE card, using this register 
to reset the card causes an Non Maskable Interrupt (NMI) to the Z-80. 
The NMI in turn causes a fetch at location 66 in RC*! vdiich contains 
a jump instruction to the Initialize routine. At the end of the 
initialize code is the wait loop the caxd performs idiile waiting for 
interrupts. In other words, on the FORDYCE card, a caxd reset using 
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this register will reinitialize the card but will NOT return to the 
code that was being executed at the time the NMI was issued. 

In the following diagrams, the first figure shows the definition of 
the bit locations when a write is issued to this register. The second 
shows the bit definitions when a read is issued. Both the card and the 
host will have occasion to write to this register. However, only the 
host will have need to read it. 

J 6 5 ^ 3 2 10 

+ + + + + + + +- + 

WRITE I reset I Don't care | 

(card I I 

+ + + + + + + + + 

Bit J: When set (1) the card is RESET and a nonmaskable 
interrupt is generated to the Z-80. This causes 
a jump to location 066H in RCM which is the 
beginning of the Z-80 initialization code. This 
bit must be cleared before another RESET can be 
issued. 

Bits 0-6: Not defined 



7 6 5 ^ 32 1 

READ iRera. | Secondary | CARD I.D. | 

jcntl [ID 00 I 1 1 I 

Bit 7: This bit is set or reset by the console DIP switch 

discussed in the last chapter. When this bit is set 
it indicates that there is a system console hooked 
up to this card. 

Bits 5»6: These bits constitute the cards' Secondary I.D. 
These bits are hardwired to 0. 

Bits 0-U: These bits form the unique I.D. code of this caxd. 
The FORDYCE card I.D. is 5 and so these bits are 
haurdwired as shown in the figure above. 



5.1.2 INTERRUPT REGISTER 



Z-80 ADDRESS: 8001H 
MAINFRAME ADDRESS: 0003H 

This register is used to enable interrupts to the host 
and to reflect the interrupt priority of the card. After card 
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initialization the card will not access the interrupt register again. 
The host will write to bit 7 ^en it wants to enable or disable 
interrupts . 

76 5 ^ 3 21 

+ + + +- + + + + + 

WRITE lint. I Don't care | 

lEnbl.j I 

+ + +-- + + + + + + 

Bit J: This bit enables and disables card interrupts to the 

host. When set (1), interrupts are enabled. When reset 
(0), interrupts to the host are disabled. 

Bits 0-6: Not defined 



7 6 5 U 3 2 1 

READ lint lint | Interrupt | Undefined for this | 
lEn'd iRqst. I Level j card | 

+ + + + + + + + + 

Bit 7: This bit indicates the current status of the host 

interrupt enable flip flop ( 'l'=enabled, '0'= disabled) 

Bit 6: This bit is set vrhen the card is requesting an interrupt 
and reset when its not. 

Bits U-5: These bits indicate the interrupt level of this caxd. 
The interrupt level is set by the two interrupt DIP 
switches . 

Bits 0-3: These bits are not defined for this caird although 
they are defined for IMA on other DIO cards. 



5.1.3 SEMAPHORE REGISTER 



Z-80 ADDRESS: 8002H 
HOST ADDRESS: OOO5H 

The semaphore register will be used by both the card and the host 
while sending and servicing interrupts generated by the interrupt 
registers (the INT-COND and COMMAND registers). The following is a 
description of the semaphore register and an explanation of its use. 
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765^3210 
+ + + + + + + + + 

|sem. I Don't care | 

i i i 

Bit 7 - This bit gives the status of the semaphore: 'O'=not busy, 
'l*=busy. The semaphore is automatically set after it is 
read . 

Bits 0-6 - These bits are not defined. 



This register is used by the caxd and the host to determine 
whether the shared RAM is cxirrently available for access. The 
semaphore register performs an indivisible read and set operation. 
When either the host or the caxd reads this register, bit 7 is set to 
indicate that a memory access is in progress. When the access is 
completed, the semaphore register can be cleared by writing auiy value 
to it. Bits to 6 axe mesuiingless . 

It should be noted that the Semaphore register does not perform 
any hardware lockout function. Its use is paxt of the backplane 
protocol. The semaphore register will only be used when either the 
card or the host wants to access one of the interrupt registers (the 
INT-COND and the COMMAND registers ) . 



5.2 REGISTERS WITH INTERRUPT CAPABILITIES 



There are two RAM registers which axe capable of generating an 
interrupt when they axe written to. These registers are used to 
send status and command information between the card and the host. 
Most of the software interfacing between the card and the host will 
be initiated throu^ these registers. The following is a description 
of each. For further information on the interrupts each of these 
registers can generate , refer to Chapter 6 , INTERRUPTS . 



5.2.1 COMMAND Register 

Z-80 ADDRESS: COOIH 
HOST ADDRESS: 8OO3H 

WRITE: HOST ONLY - GENERATES INTERRUPT TO THE Z-80 

15 
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READ : CARD ONLY - TURNS OFF INTERRUPT 

This register is used to send commands and status information 
from the host to the card. When the host writes to this register, an 
interrupt to the Z-80 is generated. The interrupt informs the card 
that there is a command to be read in the CCM4AND register. When the 
cao'd reads the register, the interrupt line is automatically cleaxed. 

The bits in the COMMAND register are used to identify the type of 
interrupt request. There axe two types of interrupts generated by 
the host; port specific interrupts and non-specific interrupts. If 
the interrupt is port specific, i.e. it pertains to a paxticular port, 
a bit will be set in the CCMIAND register to indicate idiich port. The 
actual interrupt information will be contained in a i* byte table called 
the CMND-TAB. This table will be discussed in detail in Chapter J. 

Since non-specific interrupts do not concern a particular port, 
there is a bit reserved for them in the COMMAND register. The CMND-TAB 
is not accessed. 

7 6 51^3 2 10 
+ 4. + + --+ + _+ __+ + 

I NOT I SELF I TIMER |MODM |PORT |PORT |PORT |PORT | 
jUSED ITEST I ON/OFF I | 3 I 2 | 1 | | 

COMMAND REGISTER 

BIT 0-3: A '1' in amy of these bit positions indicates 

that there is a port-specific interrupt for that port. 
The card will check the correct byte in the CMND-TAB 
to identify the interrupt. 

BIT k : A *1* in this bit position indicates that the host wants 
to change one of the modem lines. The caxd will access 
the MOEW-OUT register to determine which line to change. 

BIT 5 * A '1' in this bit position indicates that the host wants 
to turn off or on the I6 millisecond timer. 

BIT 5 : A *1' in this bit position indicates that the host wants 
the card to perform its self test. 



5.2.2 INT-COND Register 

Z-80 ADDRESS: COOOH 
HOST ADDRESS: 8OOIH 

WRITE: CARD ONLY - GENERATES INTERRUPT TO HOST 
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READ : HOST ONLY - CLEARS INTERRUPT 

The INT-COND register is used to send status information and 
messages from the card to the host . When the card writes to this 
register, am interrupt to the host is generated. The interrupt informs 
the host that there is a interrupt to be read in the INT-COND register. 
When the host reads the register, the interrupt line is automatically 
cleared. The bits in the INT-COND register are used to identify the type 
of interrupt request. 

As with the COMMAND register, there axe two types of interrupts 
generated by the card; port specific interrupts and non-specific 
interrupts. If an interrupt is port -specific, a bit will be set in the 
INT-COND register to indicate which port the interrupt involves. The 
actual interrupt information will be contained in a U byte table called 
the ICR-TAB. This table will be discussed in detail in Chapter 6. 

Since non-specific interrupts do not concern a particulax port, 
there is a bit reserved for them in the INT-COND register. The ICR-TAB 
is not accessed. 

765^3210 

+ + + + + + + +- + 

I NOT I TIME IMODM | ST |PORT |PORT jPORT |PORT | 
JUSED I OUT I IDONE | 3 I 2 | 1 | | 

INT-COND REGISTER 

BIT 0-3: A *1' in any of these bit positions indicates that there 

is a port-specific interrupt for that port. The card will 
check the correct byte in the ICR-TAB table to identify 
the interrupt . 

BIT k : This bit is set after the card has finished Self Test and 
card Initiation. This interrupt notifies the host that 
it may now commiinicate with the caxd. 

BIT 5 ' A '1' in this bit position indicates that that a change 

occurred on one of the input modem lines. The host will 
access the MOIM-IN register to determine which line 
changed. 

BIT 6 : A '1' in this bit position means that the 16 millisecond 
Receive buffer timer has gone off. The host will respond 
by retrieving any characters that are in the four Receive 
buffers. - 
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5.3 SPECIAL CHARACTER BIT MAP TABLE 



The Bit Map consists of 256 RAM locations, each byte representing 
one character. The first four bits in each byte correspond to the 
four ports on the card. 

The purpose of the Bit Map is to enable the host to be notified 
immediately when a "special" chsiracter is received. The host defines 
a character as special by setting the bit representing the port, within 
the byte vdiich represents the character. 

Vflien the card receives a chaxacter, it uses the character as an 
index into the Bit Map and checks the bit representing the port the 
character came from. If the bit is set, the card sends the host a 
Special Character interrupt. The following is an illustration of a 
Bit Map location. 



7-k 3210 

I UNUSED |port3lport2|portl|port0| 



3.k OTHER SHARED MEMORY REGISTERS 



There are a number of special purpose RAM locations idaich will 
be used to pass information between the host and the card. The 
following is a list of these shaxed RAM locations and a description 
of their usage. 

(IN HEX) 
Z-80 HOST 
RAM REGISTER DESCRIPTION ADDRESS ADDRESS 



RHEAD-0 RECEIVE FIFO HEAD POINTER - PORT 

RHEAD-1 " - PORT 1 

RHEAD-2 " - PCa?T 2 

RHEAD-3 " - PORT 3 

RTAIL-0 RECEIVE FIFO TAIL POINTER - PORT 

RTAIL-1 " - PORT 1 

RTAIL-2 " - PORT 2 

RTAIL-3 " - PORT 3 
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C700 


8E01 


C701 


8EO3 


C702 


8EO5 


C703 


8EO7 


ciok 


8EO9 


C705 


8E0B 


C706 


8E0D 


C707 


8E0F 
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THEAD-0 


TRANSMIT FIFO HEAD POINTER - PORT 





C708 


8E11 


THhIAD-l 


- PORT 


1 


C709 


8E13 


THKAD-2 


- PORT 


2 


C70A 


8E15 


THKAD-3 


- PORT 


3 


C70B 


8E17 


Ti'AIL-O 


TRANSMIT FIFO TAIL POINTER - FORT 





C70C 


8E19 


Ti'AIL-l 


- PCBT 


1 


C70D 


8E1B 


TTAIL-2 


- PORT 


2 


C70E 


8E1D 


TTAIL-3 


- PORT 3 


C70F 


8E1F 


CONFIGURATION 


DATA REGISTERS: 








CONFG-0 


LINE SPECS REGISTER - PORT 




C710 


8E21 


BD-0 


BAUD RATE INDEX - 




C711 


8E23 


CONFG-1 


LINE SPECS REGISTER - PORT 1 




C712 


8E25 


BD-1 


BAUD RATE INDEX - " 




C713 


8E27 


CONFG-2 


LINE SPECS REGISTER - PORT 2 




C7lU 


8E29 


BD-2 


BAUD RATE INDEX - 




C715 


8E2B 


CONFG-3 


LINE SPECS REGISTER - PORT 3 




C7l6 


8E2D 


BD-3 


BAUD RAT'E INDEX - 




C717 


8E2F 


MODM-IN 


MODEM INPUT LINES 




C718 


8E31 


MODM-OUT 


MODEM OUTPyi' LINES 




C719 


8E33 


MODM-MASK 


MODEM MASK FOR INPUT LINES 




C71A 


8E35 


CMND-TAB 


CC»MAND REG. INTERRUP-T DATA 
k BYTES - 1 PER PORT 




C71B 


8E37 


ICR-TAB 


INTCOND REG. INTERRUPT DATA 
k BYTES - 1 PER PORT 




C71F 


8E3F 


ST-COND 


SELF TEST RESULT REGISTER 




C723 


8EU7 



The following is a more detailed explsoiation of the uses of the 
Shared RAM registers. 
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5.U.1 RECEIVE FIFO HEAD POINTERS 



These pointers contain the index of the current head of the 
Receive buffers. The receive buffer head pointers are updated by 
the host **Len it removes data from the Receive buffers. 



5.^.2 RECEIVE FIFO TAIL POINTERS 



These pointers contain the index of the current tail of the 
Receive buffers. The receive buffer tail pointers are updated by the 
card when it places new data into the Receive buffers. 



5.U.3 TRANSMIT FIFO HEAD POINTERS 



These pointers contain the index of the current head of the 
Transmit buffers. The transmit buffer head pointers are updated by 
the card when it removes data from the transmit buffers. 



5.U.U TRANSMIT FIFO TAIL POINTERS 



These pointers contain the index of the current tail of the 
Transmit buffers. The transmit buffer tail pointers axe updated by 
the host vrhen it places new data into the Transmit buffers. 



5.U.5 CONFIGURATION DATA REGISTERS 



As shown above, there axe two bytes of configuration data for each 
port. The first byte (CONFG) is used to specify parity, bits per 
chaoi^cter, and number of stop bits per character for each port. The 
second byte, BD, contains a value which corresponds to the desired 
baud rate. Both registers axe detailed in the following paxagraphs. 

CONFG REGISTER 



This register is used to specify three pieces of configuration 
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information; paxity method, number of bits per chaxacter, and the 
number of stop bits per character. The options shown below are the 
only ones supported on the card. For example, the card can only 
support 5»6,7, or 8 bits per character. 

7-6 5 k 3 2 1 



IDONT CARE! 



I I I 



- NO PARITY 

1 - ODD PARITY 

1 - EVEN PARITY 

0-1 STOP BIT/CHARACTER 

1 - 1-1/2 STOP BITS/CHARACTER 

0-2 STOP BITS/CHARACTER 



5 BITS/CHARACTER 

6 BITS/CHARACTER 

7 BITS/CHARACTER 

8 BITS/CHARACTER 



BD REGISTER 



This register is used to indicate the baud rate the host wants 
the port set to. Ilie following is a list of the values which 
correspond to the available baud rates. 



BD REGISTER VALUE (HEX) 

1 
2 

3 
k 

5 
6 

7 
8 

9 

A 

B 

C 

D 

E 

F 
10 
11 



BAUD RATE (BITS/SEC) 



50 

75 

110 

13^.5 

150 

300 

600 

900 
1,200 
1,800 
2,it00 
3,600 
U,800 
7,200 
9,600 
19,200 
38,i+00 



21 



(Page 25 of 43) 



5.U.6 MODEM INPUT LINES 



The first four bits in this register aire used to represent the 
four input modem lines. The remaining four bits are unused. The host 
will read this register when it wants to know the status of the input 
modem lines - i.e. which ones are on and which are off. The card will 
update this register when it receives notification of an input modem 
line change from the UART. If one of these lines change, the card will 
access the MOEW-MASK register to see if the host wants to be 
interrupted for a change on that particulaur line. MOIW-IN will always 
contain a copy of the current status of the input modem lines. 

MODM-IN REGISTER 



7-k 3 2 10 

I DONT CARE | CS i DM | RR | IC 



CS - Clear to Send 
RR - Receiver Ready 
IC - Incoming Call 
DM - Data Mode 



5.i*.7 MODEM OUTPUT LINES 



The first three bits in this register are used to represent the 
three output modem lines. The remaining five bits are unused. When 
the host wants to change a particular output modem line it will write 
to this regiister setting the appropriate bit position, and generate a 
Modem Output Change interrupt to the caa:d. The MOEM-OUT register will 
always contain the current status of the modem output lines. 

MODM-OUT REGISTER 



7-3 2 10 

I DONT CARE | SR | TR | RS 



SR - Signal Rate Selector 
TR - Terminal Ready 
RS - Request to Send 
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5.1+.8 MODEM MASK 



The first four bits in this register correspond to the first four 
bits in the MOIW-IN register. The other four bits will be set. If 
there is a change on one of the input modem lines, this register will 
be used by the card to determine whether the host wants to be inter- 
rupted. If the bit in MODM-MASK correspoding to the input line is set, 
the card will send the host a Modem Input Change interrupt. If the 
bit is reset , the caxd will not send an interrupt . The format of 
MODM-MASK exactly matches that of MODM-IN. 



5.^.9 INT-COND REGISTER INTERRUPT DATA ( ICR-TAB ) 



This is a U byte table which is used to identify port specific 
interrupts sent by the catrd to the host. This table is used in 
conjunction with the INT-COND register. Each of the bytes in the 
ICR-TAB is reserved for one of the k ports. When the card sends the 
host a port specific interrupt (one of the port bits (0-3) in the 
INT-COND register is set), the host will read the corresponding byte 
in ICR-TAB for the actual cause of the interrupt. See Chapter 7» 
INTERRUPTS for more detail on ICR-TAB. 



5.U.IO COMMAND REGISTER INTERRUPT DATA (CMND-TAB) 



This is also a k byte table. It is used the same as the ICR-TAB 
except that it identifies port specific interrupts from the host to 
the card. The CMND-TAB is used in conjunction with the CCWMAND 
register. See Chapter 7 for more detail on CMND-TAB. 



5.U.II SELF TEST RESULT REGISTER 



This register is used to indicate the result of Self Test. If 
Self Test passed, STCOND will contain the value OEOH. If Self Test 
failed, the ST-COND register contains the value of the IX register 
(internal to the Z-80) at the time of failure. This value indicates 
what routine the Self Test was executing when it failed. A list of 
of the Self Test routines and corresponding IX values can be fo\ind 
in Chapter 10, Self Test. 
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+ + ^ 

I I i 

I SHARED MEMORY ACCESS AND DATA FORMATS | CHAPTER 6 | 

I i I 

+ + + 



As previously mentioned, there is 2K bytes of shared RAM on the 
FORDYCE card. All of the conmninication between the card an4 the h^^ 
will be via shared RAM (the INT-COND and COMMAND registers are part 
of the RAM address space). The purpose of this chapter is to describe 
shared memory access protocols . This includes a description of the 
FIFO buffers, receive and transmit data formats, FIFO pointer 
management. Transmit FIFO protocol, and Receive FIFO protocol. 



6.1 BUS ARBITRATION 



The host and the card will alternate RAM accesses when they both 
need the bus at the saime time. This is accomplished in the hardware. As 
a result, if both the card and the host try to access RAM at the same 
time, the host will get the bus for one memory access, then the card. In 
a worst case situation the host and the caxd will have to wait one RAM 
cycle between each memory access. 

There is one exception to the above. Both the caxd aind the host 
will use the Semaphore register to lock each other but when sending or 
responding to card-to-host or host-to-card interrupts. These interrupt 
processes are critical regions for both the host and the card and, as 
such, will be protected by mutual use of the Semaphore register. The us# 
of the Semaphore register in the interrupt processes will be described in 
more detail in Chapter 7. 



6.2 POINTER MANAGEMENT - RECEIVE AND TRANSMIT BUFFERS 



Ajs discussed previously, there are a total of eight buffers, each 
organized as a circular FIFO queue; one Receive buffer and one Transmit 
buffer for each of the four ports. There are two pointers associated 
with each of the buffers; a head pointer and a tail pointer. Both of 
these pointers will be indexes from a Base FIFO address. The base 
address will be hard-coded. 
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The management of the head and tail pointers is the responsibility 
of both the card and the host. The card will be adding data to the 
Receive buffers and removing data from the Transmit buffers. Therefore, 
it will be responsible for updating the Receive buffer Tail pointers and 
the Transmit buffer Head pointers. Conversly, the host will be removing 
data from the Receive buffers and adding data to the Transmit buffers. 
It will be responsible for updating the Receive buffer Head pointers and 
the Transmit buffer Tail pointers. 



6.3 RECEIVE DATA FORMAT 



The receive data format scheme requires two bjrtes per chaxacter. 

The first byte will be the character and the second byte will be the 

status byte which contains error information and break detection. The 
data format is illustrated below: 



7 6 5 it 3 2 1 

I CHARACTER 

I 

I F I ] P I B I OVF I UNUSED 



1. (F) Framing Error - This is to notify the host that a framing 

error occured on this character. 

2. (0) Overrun Error - This is to nptify the host that a UART 

overman condition occurred on this 
chaxacter . 

2. (P) Parity Error - This is to notify the host that a parity 

error occured on this character. 

k. (B) BreaJt Detection - This is to notify the host that a BreaJt 

was received. The character will be null. 

5. (OVF) Overflow Error - This is to notify the host that a 

Receive buffer overflow condition 
occurred before this character. 
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6.k RECEIVE FIFO BUFFER MANAGEMENT 



As discussed before, there axe four receive buffers, one for each 
port. They are organized as circular FIFO data structures of 256 b3rtes 
each. As each character requires 2 bjrtes, this is ^hotigh buf ff r Spac% 
for 128 characters per port* 



6.U.1 TIME-OUT TIMER FOR RECEIVE CHARACTERS 



As discussed previously, the card will interrupt the host every I6 
milliseconds . The host will respond to this interrupt by emptying all 
of the characters in the fotir Receive buffers. The tiiner will 
cycle contiJi^ousl^ whether there is Receive data in the buffers or not . 
The host does have the option to turn off the timer if it so desires by 
sending a Timer Off /On interrupt. This interrupt is discussed in more 
detail in Chapter 7- 



6.U.2 CARD PROCESS FOR RECEIVE BUFFER MANAGEMENT 



The card will only access the Receive FIFO buffers when a 
Receive character has arrived at a port. When a chaxacter arrives 
the following sequence of events is performed by the caxd. 

1. Check if the buffer is full. If so, the card will simply exit 
this routine without retrieving the chaxacter from the UART. 

NOTE: The UART has a three byte internal buffer which insures a 
little protection in the event the Receive buffer is full. 
However, if there is still no room in the Receive buffer 
when the fourth chaxacter axrives, the UART will ovemin. 
It is the responsibility of the host to service the buffer 
enough to prevent this occurence. There will be no over^m 
prevention done on the card. 

2. Retrieve the character from the UART. 

3. Strip any parity bits 

U. Create the status byte 

5. Check the Bit Map location for the character. If the correct bit 
is set, it identifies the character as a "special character" and 
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the caxd sends a Special Character interrupt to the host. 

6. Write both the character and the status byte to the FIFO buffer and 
update the appropriate pointers. 



6.U.3 HOST PROCESS FOR RECEIVE BUFFER MANAGEMENT 

The host will only access the Receive FIFO buffers after it 
receives a Time -Out interrupt from the card. The, Time -Out interrupt 
will occur every l6 milliseconds whether there is data ih the Receive 
buffers or not. Upon receipt of the interrupt, the host will begin 
checking and emptying all four Receive buffers. The host will perform 
the following sequence of events for each Tirae-Out interrupt. 

1. If head=tail then exit (buffer empty) else . . . 

2. Retrieve data byte and status byte. 

3. Update buffer pointers. 
k. Begin sequence again. 



6.5 TRANSMIT DATA FORMAT 



There is really no tramsmit data format to speak of. As there is 
no status byiie^^^a^^ the transmit buffers 

will sinQ>ly contain characters to transmit. 



6,6 TRANSMIT FIFO BUFFER MANAGEMENT 



As discussed previously, there are four trainsmit buffers, one 
for each port. They are orgauiized as circular FIFO queues of l6 
bytes each, one byte per character. 
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6.6.1 CARD PROCESSING FOR TRANSMIT BUFFER MANAGEMENT 

The caxd begins to send transmit data out the port after it 
receives a TX Buffer Not Empty interrupt from the host informing it 
that the transmit buffer for the port is no longer empty. The caxd 
staxts the UART and begins sending out characters. The card performs 
the following sequence of events. 

1. If head=tail then exit (buffer empty) else. . . 

2. Retrieve character and send to the UART. 

3. Update necessary po inter (s). 

6.6.2 HOST PROCESSING FOR TRANSMIT BUFFER MANAGEMENT 



The host will add data to the Transmit buffers whenever it has the 
need unless the intended buffer is full. If the host encouaters a 
full buffer, it will back off and wait for a TX Buffer Empty interrupt 
from the card. The TX Buffer Empty interrupt informs the card that 
there is now room in the Transmit buffer for more characters. The 
following is the sequence of events the host performs for each 

If the buffer is empty when the host wants to put characters in 
the host will send the caxd a TX Buffer Not Empty interrupt . This 
interrupt tells the card that there axe now more characters to send 
to the UART. ISie following is the sequence of events the host executes 
for each chaxacter it wants to place in a Transmit buffer. 

1. Is the Transmit buffer full? If yes, exit routine. 

2. Is the Transmit buffer empty? If yes, send a TX Buffer Not Empty 
interrupt to the caxd. 

3« Do the following until either finished or buffer full 

a. Put character into buffer 

b. Update pointer. 
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I INTERRUPTS | CHAPTER 7 I 

I i I 

+ . + + 



This chapter will be divided into two general discussions. The 
first will be an overview of the Interrupt sending and receiving 
process between the caxd and the host. The second will be an 
explanation of each of the possible card-to-host auad host-to-card 
interrupts . 

NOTE: Both the host and the card will assume that there may be more 
than one bit set (more than one interrupt) in the interrupt register 
when the actual interrupt signal is received. This is the reason that 
a bit is reserved for each type of interrupt instead of using a value 
to represent a particular interrupt. 



7.1 INTERRUPT SENDING AND RECEIVING - SEMAPHORE REGISTER 



The interrupt process between the host and the card is critical 
to both and, as such, csmnot tolerate a possible interleaving of memory 
accesses. As a result, the semaphore register will be used by both the 
card aind the host ais notification that a critical process is being 
performed . 

Whenever either the host or the caxd is sending or receiving an 
interrupt, both will check the Semaphore register before accessing the 
interrupt register. If bit 7 in the Semaphore is "0", the interrupt 
registers are not being accessed and the side checking the register 
may proceed. If bit 7 is "1", the other side is in the critical region. 
The side wishing to begin must wait. For exanrple, if the host wants 
to send an interrupt to the caxd, it will first check the Semaphore 
register. If bit 7 in the Semaphore register is set, the card is in 
the process of accessing one of the interrupt registers. The host will 
wait for the Semaphore register to be cleared before sending the 
in"|errupt. 
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7.2 HOST-TO-CARD INTERRUPTS 



These interrupts are generated when the host writes to the COMMAND 
register. As mentioned previously, if the interrupt is port -specific, 
the bit in the COMMAND register indicating the port will be set and 
the bit in CMND-TAB indicating the interrupt will be set. In other 
words , if the inteiTrapt is port-specific the card will check the 
corresjkjnding byi;e^^^ i^ If the interrupt 

is not port-specific, CMND-TAB will not be accessed. 



COMMAND REGISTER 



CMND-TAB 



{non-specific} {port-specific} 
765^3210 

IxxxIST |TME|M0D|P3 |P2 jPl |P0 | 

I I 



7-3 


2 1 





1 UNUSED 


|BRK |TX 


ICON 1 


1 


jBRK |TX 


ICON 1 


1 


IBRK |TX 


ICON 1 


1 


IBRK jTX 


ICON 1 



NON-SPECIFIC INTERRUPTS 



1. MODEM OUTPUT CHANGE (MOD) - This interrupt is used in conjunction 

with the M0W4-0UT register. The host will generate this interrupt 
^en it wants the card to change one or more of the modem output 
lines. After receiving this interrupt, the card will read the 
MOEW-OUT register and set the indicated modem lines. 

2. TIMER OFF/ON (TME) - This interrupt is used to toggle the timer on 

and off. If the timer is on when this interrupt is received, the 
caxd will turn the timer off. If the timer is off, the caxd will 
turn it back on again. 

3. SELF TEST ON (ST) - "niis interrupt tells the card to begin Self 

Test. The purpose of this interrupt is to give the host the 
capability of d3m2Lmically invoking Self Test without having to 
power the system down amd back up. 
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NOTE: It is critical that the host does not interrupt the 
card after invoking Self Test until the card sends a Self 
Test Done interrupt. 

PORT-SPECIFIC INTERRUPTS 



1. CONFIGURATION DATA CHANGE (CON) - This interrupt informs the card 

that the host has chajiged the configuration data for the indicated 
port. Configuration data includes line chsiracteristics aoid baud 
rate for the specified channels. The caxd will respond to this 
interrupt by changing the line configuration and baud rate as 
specified in the CONFG aind BD registers. 

NOTE: The host waits for the TX buffer to be empty before 
sending the interrupt so that there is no timing collision. 

2. TRANSMIT BUFFER NOT EMPTY (TX) - This interrupt tells the card that 

the host has put data into a previously empty Transmit buffer. 
Upon receipt of this interrupt, the caxd will start the UART and 
begin retrieving chaxacters from the Transmit buffer. 

NOTE: This interrupt is identified and processed after the config- 
uration interrupt so that no transmit data is sent until the card 
has completely finished changing the line configuration for the 
port. 

3. SEND BREAK (BRK) - This interrupt works as a toggle. The first 

time it is sent, it informs the card to send a break on the port 
specified. The break condition remains imtil the card receives 
this interrupt a second time pdaich tells it to stop the break. 



7.3 CARD-TO-HOST INTERRUPTS 



These interrupts are generated when the card writes to the INT-COND 
register. As mentioned previously, if the interrupt is port-specific, 
the bit in the INT-COND register indicating the port will be set and the 
bit in ICR-TAB indicating the interrupt will be set. In other words, if 
the interrupt is port-specific the host will check the corregpqln^ 
in ICR-TAB for the interrupt. If the interrupt is not port-specific, 
ICR-TAB will not be accessed. 
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INT-COND REGISTER ICR-TAB 

{non-specific} (port-specific) 
765^3210 



I XXX I TME I MOD I ST |P3 |P2 |P1 |P0 | 





7-2 


1 


> 1 


UNUSED 


ISPECl TX 1 


> 1 


II 


ISPECl TX 1 


> 1 


II 


ISPECl TX 1 


> 1 


II 


ISPECl TX 1 



NON-SPECIFIC INTERRUPTS 



1. TIMER (TME) - The caxd will send the host a Time -Out interrupt 

every 16 millisecdndsffe This signals the host to come retrieve 
any chaxacters that might be in the Receive buffers. The host 
will respond to this interrupt by checking to see if the buffers 
are empty and retrieving all characters from the Receive buffers 
that are not empty. 

2. MODEM INPUT CHANGE (MOD) - This interrupt is used in conjunction 

with the MODM-IN and the MODM-MASK registers. The card will send 
this interrupt to the host when there has been a change in one of 
the modem lines indicated by the MODM-MASK register. If there is 
a change in a modem line whose corresponding bit in the MODM-MASK 
is not set, the card will not issue this interrupt. 

3. SELF TEST COMPLETE (ST) - This interrupt informs the host that the 

card has completed Self Test. The host will check the ST-COND 
register to determine whether Self Test passed or failed. If 
Self Test passed it also means that the caxd is initialized and 
ready for processing. 

PORT-SPECIFIC INTERRUPTS 



1. SPECIAL CHARACTER RECEIVED (SPEC) - This interrupt is sent when 
the card receives a character whose bit position in the Bit Map 
was set. Possible special characters might be XOFF, XON, etc. 
As mentioned previously, the host is responsible for designating 
which characters are special. 
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2. TRANSMIT BUFFER EMPTY (TX) - This interrupt informs the host that 

the Transmit Buffer for the port indicated is now empty. When the 
host wants to send the card a character but finds the Transmit 
buffer full, it will back off and wait for this interrupt before 
attempting to send any more characters. 
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MODEM SUPPORT | CHAPTER 8 

I 

_ + 



FOE?DYCE supports full-duplex modem trainsmission. However, as this 
is a dumb card, the majority of the modem control will be the 
responsibility of the host. The firmware will only report changes in 
the input modem lines and set signals on the output modem lines per 
host request. The modem interface between the caxd and the host is 
limited to the MODM-IN and MODU-OUT registers which have been 
previously discussed in Chapters 5 ^Jid J. 

As the modem port can also be used as a direct connect port, it is 
the responsibility of the host to detect whether a modem is connected 
or not. The following modem lines will be supported: 

SIGNAL DIRECTION 
CARD E«:VICE 






MODEM LINE 


EIA RS-1*U9 


DESCRIPTION 


SYMBOL 


Send data 


SD 


Receive data 


RD 


Request to send 


RS 


Clear to Send 


CS 


Receiver ready 


RR 


Incoming call 


IC 


Terminal ready 


TR 


Data mode 


DM 


Signal rate selector 


SR 


Signal ground 


SG 
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+ + + 

I i I 

I SELF TEST | CHAPTER 9 | 

i i I 

+ + + 



Self Test is the on-board diagnostic program which functionally 
tests all of the hardware on the caxd. It includes a E(M test, a RAM 
test, a CTC test, and a SIO test. There are two ways to invoke Self 
Test. It is automatically invoked during power up wtoen the Auto Reset 
line is pulled and it may be invoked dynamically by a Self Test 
interrupt from the host . 

WARNING: The host must NOT attempt to interrupt the card until it has 
received the Self Test Done interrupt from the card. 

Upon successful completion of Self Test, the following will occur: 

1. The ST-COND register contain the value OEOH to indicate that Self 
Test passed. 

2. The ca^rd will send the host a Self Test Complete interrupt. 

3. The caxd will execute the initialization routine. 

Upon unsuccessful termination of Self Test, the following will 
occur: 

1. !nie ST-COND register gets the value in the IX register. This 
value indicates where the test failed (see following section). 

2. The caxd will send the host a Self Test Complete interrupt. 

3. The host will display a message stating that Self Test on the 
card failed and give the number of the routine (in STCOND) in 
which the failure occurred (see the following section for the 
error numbers and their corresponding descriptions. 

3. The card will execute the initialization routine. 

NOTE: When the Self Test fails, the host will ignore the card that 
the failure occurred on. However, the caxd will still execute the 
initialization code- This is so the user may still access the card 
if it is deemed that the failure can be worked around. For example, 
if Self Test fails on the external loopback test for port 3» the user 
could still conceivably use the card, running the other 3 ports that 
passed. However, it should be noted that the Self Test checks each 
component in the order that they occur on the following page. If 
any test fails. Self Test quits executing and jumps to the initializ- 
tion routine. Therefore, if the caxd fails the external loopback 
test for port 0, ports 1 through 3 have not executed the external 
loopback test. It cannot be assumed that they axe safe to use. 
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9.1 VALUE OF ST-COND REGISTER UPON SELF TEST FAILURE 



As stated above, when Self Test fails, a ntunber representing the 
section of Self Test that failed is written to the ST-COND register. 
The following list defines each of these possible numbers. In the 
event of Self Test failure, the host can read the ST-COND register 
to determine where the failure occurred. 

The ST-COND values are defined as follows: 



ST-COND = 1: 
= 2: 

= 3: 
= k: 

= 5: 
= 6: 

= 7: 
= 8: 

= 9: 
=10: 
=11: 
=12: 

=13: 
=1U: 

=15: 
=16: 

=17: 



INT-COND/INTERRUPT register test 

NMI /RESET I.D. register test 

Semaphore register test 

ROM Test 

RAM Test 

CTC Test - ALG. 1 

CTC Test - ALG. 2 

CTC 1 Test - ALG. 1 

CTC 1 Test - ALG. 2 

SIO CH A Test (Internal loopback) 

SIO CH B Test (Internal loopback) 

SIO 1 CH A Test (Internal loopback) 

SIO 1 CH B Test (Internal loopback) 

SIO CH A Test . (with diag hood - external 

SIO CH B Test (with diag hood - external 

SIO 1 CH A Test (with diag hood - external 

SIO 1 CH B Test (with diag hood - external 



loopback) 
loopback) 
loopback) 
loopback) 
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PSEUDOCODE OUTLINES OF BUFFER ACCESS ROUTINES j CHAPTER 10 \ 



The purpose of this chapter is to define the FIFO buffer access 
routines for the card and the host in a pseudocode fashion. These 
pseudocode routines outline the general steps required to retrieve or 
place chaxacters in the FIFO buffers. Since there is little difference 
in placing chaxacters from different ports into their respective buffers, 
the following routines are not port specific. In other words, the same 
sequence of steps will be performed regardless of idiich port or which 
buffer is being serviced. 

Most of the variable names used in the following pseudocode have 
been defined in Chapter U under Other Shaxed Memory Locations. The 
exception will be "FLAG" which is used in most of the routines. This 
refers to an lanshared memory location used solely in the routine in i^ich 
it appears. Itnother *rords^ egicb^ The common 

use of the name "FLAG" is for descriptive simplicity. 

In some of the following routines there will be descriptive 
sentences (in lowercase) instead of pseudocode. These describe a 
specific fianction that must be performed which does not lend itself 
readily to a pseudocode explanation. 



10.1 RECEIVE BUFFER ACCESSING 



HOST ROUTINE 



This routine is generated by a Timer interrupt from the card. 
The purpose of this routine is to check the Receive buffer and empty 
any characters found. This routine loops until all characters and 
their corresponding status bytes have been retrieved from the designated 
buffer. This routine is performed for each Receive buffer. 

WHILE (HEADoTAIL) DO 
BEGIN 

Retrieve chairacter from buffer 
Retrieve status byte from buffer 
Update head pointer 
Host character processing 
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END 
CARD ROUTINE 



This routine is the Interrupt Service Routine performed by the card 
in response to a Receive character interrupt from the UAKC. This routine 
services one character. 

IF (TTAIL+2)=THEAD THEN 
BEGIN 

Retrieve character from UART & discard 
Set Bit 3 in status byte for next character 
END 
ELSE 
BEGIN 

Retrieve chaxacter & strip any parity bits 
Do Bit Map check 
IF special character THEN 
BEGIN 

Grab semaphore 

Send Special Character interrupt to host 
Release semaphore 
END 
Put character into FIFO 
Put status byte into FIFO 
Update pointer 
END 



10.2 TRANSMIT BUFFER ACCESSING 



HOST ROUTINE 



The host generates this routine under two possible circumstances. 
The first circumstance is whenever the host has data it wants to send 
to the card. The second circumstance is in response to a Transmit 
Buffer En^ty interrupt from the card (presuming the host has chaxacters 
it wants to send) . 

IF (TAIL+2)<>HEAD THEN If buffer not full then . . . 

BEGIN 

IF TAIL=HEAD THEN send TX Buffer Not Empty interrupt to card 

Put chaxacter into buffer 

Update tail pointer 
END 
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CARD ROUTINE 



This is the Interrupt Service Routine performed by the card in 
response to a Transmitter Empty interrupt from the UART. This is 
also basically the routine performed when the host sends the caird a 
TX Buffer Not Empty interrupt with one addition: the caxd must "staxt' 
the UART before sending the 1st character out. After that, the UART 
will interrupt the Z-80 when its ready for the next character. 



IF HEAD=TAIL THEN If buffer empty 

BEGIN 

Turn off UART 
Grab semaphore 

Send TX Buffer Empty interrupt 
Release semaphore 
END 
ELSE 
BEGIN 

Retrieve character from FIFO 
Send character to UART 
Update head pointer 
END 
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VISION HISTORY 

The following is a detailed history of the bug fixes that have occurred 
since the firmware was first released on 5/01/85. The only other change 
made to the IMS is the ROM map reflects the load map of the new version 
of firmware. 

BUG FIX - 6/13/85 

BRIEF DESCRIPTION - BUG IN SELF TEST 

SYMPTOM - The card was unable to receive interrupts after Self Test 
had failed if the Self Test failure was because a deadman timer 
had timed out (i.e., SIO test external loopback) • 

REASON - The deadman timer was set up as a countdown to then interrupt 
in the CTC. The end of the deadman timer interrupt was a jump to 
ST_ERR which never did a RETI. Therefore, interrupts were never 
getting enabled again. 

SOLUTION - The solution was to add the instructions: 

LD BC,INIT 
PUSH BC 
RETI 

Self Test failures which do not involve ISR's (like the semaphore 
test) still jump to the ST_ERR routine and an extra RETI instruction 
only pops the stack. 

BUG FIX - 4/09/86 

BRIEF DESCRIPTION - THERE WAS ONLY ONE VARIABLE FOR RX CHAR BIT MASK 

SYMPTOM - When the user set the bits-per-character configuration, it 
was set for all the ports. In other words, if the user set 1 port 
at 8 bits per character and another at 7 bits per character with 
parity, all the ports were stripping the top character and adding 
parity. The data on the port that the user thought was 8 bits-per 
character was erroneous. 

REASON - There was only 1 variable to strip leading bits on RX 
characters for all four ports. This was BITS_MSK. There should 
have been 1 for each port. 

SOLUTION - I eliminated the variable BITS MSK and created four new 
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